home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_3 / pickfile / pickfile.dok < prev    next >
Text File  |  1998-01-01  |  15KB  |  384 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                             Dokumentation zu
  7.  
  8.  
  9.  
  10.  
  11.                       PickFile Version 1.2 FreeWare
  12.  
  13.  
  14.  
  15.  
  16.                            ® 1992/93 von H.P.G
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23. Index:
  24. ======
  25.  
  26.  
  27.         Index
  28.         Was ist PickFile ?
  29.         System Vorraussetzungen
  30.         Rechtliches
  31.         PickFile Startoptionen
  32.         Beispiele
  33.         Technisches
  34.         Zum Schluß
  35.         Adresse
  36.         Liste der Dateien
  37.  
  38.  
  39.  
  40. Was ist PickFile ?:
  41. ===================
  42.  
  43.         Mit dem neuen Betriebssystem 2.0 ist es nun möglich, auf einfache
  44.         Art und Weise unterschiedliche Fonts, Pattern, Farben oder Mouse-
  45.         Pointer zu verwenden.
  46.  
  47.         Seit ich dieses Betriebssystem benutze, freue ich mich über ein
  48.         gutes WBench- oder Fenster-Muster oder über verschiedene Overcan-
  49.         größen und nicht zuletzt über die unterschiedlichen Fonts, für
  50.         Fenster und Screens.
  51.  
  52.         Doch wenn ich z.B. einige Zeit das gleiche Muster für meine Fenster
  53.         benutzt habe, möchte ich dieses ändern.
  54.  
  55.         Also: starte ich ersteinmal das WBPattern-Programm im
  56.         sys:prefs/ - Verzeichnis ...
  57.  
  58.         Habe ich dann ein solches Muster zufriedenstellend entworfen,
  59.         speichere ich es als default ab. Nach einiger Zeit wiederholt
  60.         sich dieser Vorgang nicht nur für Pattern, sondern auch für
  61.         Fonts und Farben usw.
  62.  
  63.         PickFile schafft hier Abhilfe.
  64.         PickFile wählt aus einer Liste oder optional aus einen Ver-
  65.         zeichnis einen Eintrag `zufällig` aus und führt dann die vorher
  66.         angegebenen Kommandos aus.
  67.         PickFile ist sehr vielseitig und eignet sich zum Auswählen
  68.         (PickUp) von allen Arten von Dateien und Programmen.
  69.         Dabei kann PickFile (PF) nicht nur Dateien auswählen, sondern
  70.         diese auch starten. Man kann eine ganze Kommandozeile an PF
  71.         übergeben.
  72.         Es ist auch möglich PickFile mehr als nur einen Eintrag aus-
  73.         wählen zu lassen.
  74.         Um über alle Möglichkeiten zu sprechen fehlt mir hier die Zeit.
  75.         Die Anwendungsgebiete erstrecken sich von Aufrufen von (wie be-
  76.         reits beschrieben) Prefs-Dateien bis hin zum Starten von Sampled-
  77.         Sounds, starten von SlideShows mit zufälliger Reihenfolge ...
  78.  
  79.         Ich habe wegen der vielfältigen Möglichkeiten eine Beispiel-
  80.         Datei beigelegt und zeige später einige Beispiele auf.
  81.  
  82.  
  83. System Vorraussetzungen:
  84. ========================
  85.  
  86.         PickFile benötigt mindestens Kickstart 2.04 Version 37L++.
  87.         Unter den Versionen 36L (1.4) und unter 1.3 ist es leider
  88.         nicht lauffähig, da dieses Programm regen Gebrauch der neuen
  89.         Pattern-Matching und Kommandozeilen-Parsing Routinen macht.
  90.         (Sorry).
  91.  
  92.  
  93. Rechtliches:
  94. ============
  95.  
  96.         Ich habe mich entschlossen dieses Programm und alle beigefügten
  97.         Dateien und Scripts, sowie aller Anleitungen, als FREEWARE   zu
  98.         deklarieren.
  99.  
  100.         D.h.:
  101.  
  102.             Jeder kann PickFile benutzen.
  103.             Jeder darf PickFile weitergeben, wenn:
  104.  
  105.                 1. Alle unten aufgeführten Programme mit  weitergegeben
  106.                    werden,
  107.  
  108.                 2. Keinerlei Veränderungen der unten aufgeführten  Pro-
  109.                    grammen (am Ende der Anleitung)  vorgenommen wurden,
  110.  
  111.                 3. Bei  Nachkompilierungen  der QuellCodes muß ein Hin-
  112.                    weis  auf  den  Orginalprogrammierer beigefügt sein,
  113.                    bei  Herausgabe  dieser,  muß  eine  Kopie  an  mich
  114.                    gesandt werden.
  115.  
  116.                 4. PickFile darf nicht verkauft werden.
  117.  
  118.                        Außnahme: Es darf eine geringe  Kopiergebühr er-
  119.                                  hoben werden, die aber  5 DM  bzw. den
  120.                                  entsprechenden  Gegenwert  in  anderen
  121.                                  Währungen nicht übersteigt.
  122.  
  123.                 5. PickFile darf nur als Teil eines kommerziellen Produktes
  124.                    herrausgegeben  werden,  mit ausdrücklicher schrift-
  125.                    licher Genehmigung des Autors (Adresse siehe unten).
  126.  
  127.                 Zuwiderhandlungen  der  oben  Aufgeführten  Konditionen
  128.                 werden Zivilrechtlich verfolgt.
  129.  
  130.  
  131.         Ferner  wird  für  die Funktion des Programmes ,sowie möglicher
  132.         Folgen  der  Benutzung  des Programmes sowie der u. a. Dateien,
  133.         keinerlei Gewährleistung übernommen.
  134.  
  135.         !!! Alle Risiken trägt der Benutzer allein !!!
  136.  
  137.  
  138. PickFile Startoptionen:
  139. =======================
  140.  
  141.     Wird PF von der WBench aus aufgerufen, wird nur ein kurzer Hilfstext
  142.     ausgegeben.
  143.     Startet man PickFile vom CLI aus, so hat es folgende
  144.  
  145.     Syntax: [File=F/K][Dir=D/K][MinVal=M/N][MaxVal=X/N][Test=T/K]
  146.             [Quiet=Q/K][Help=H/S][Cmd=C/F]
  147.  
  148.     File=F/K   :   Ist dies angegeben, liest PF diese Datei und wählt
  149.                    eine Zeile dieser Datei nach einem Zufallsprinzip
  150.                    aus. Dies ist der schnellste Weg, PickFile zu be-
  151.                    nutzen. Die angegebene Datei wird in den Speicher
  152.                    geladen und erst dann gelesen. Dies erspart Zeit.
  153.                    Zur Syntax dieser Auswahldatei gebe ich später
  154.                    einige Beipiele an.
  155.  
  156.     Dir=D/K,   :   Ist Dir angegeben, wird anstelle einer Datei ein
  157.                    Verzeichnis durchsucht. Es wird nach dem Zufalls-
  158.                    prinzip eine Datei des Verzeichnisses ausgewählt.
  159.                    Je nachdem, ob eine Kommandozeile übergeben wurde
  160.                    (siehe unter Cmd), wird diese Datei entweder als
  161.                    Programm gestartet oder es wird der Name dieser
  162.                    Datei in die Komandozeile eingefügt.
  163.  
  164.     Pat=P/K    :   Hinter Pat kann man ein Suchmuster (Pattern) nach
  165.                    AmigaDOS-Standart angeben. Es werden dann zur Aus-
  166.                    wahl nur Dateien berücksichtigt, die diesem Muster
  167.                    entsprechen. Ist kein Verzeichnis angegeben, sondern
  168.                    nur eine Datei (siehe unter File), wird Pat ignoriert.
  169.  
  170.     MaxVal=X/N :   Hier kann man die Anzahl der Einträge, die PickFile
  171.                    auswählen soll, angeben. Wird hier eine größere Anzahl
  172.                    angegeben, als in dem Verzeichnis Dateien vorhanden sind
  173.                    oder mehr Zeilen als in einer Datei stehen, wird die
  174.                    maximal mögliche Zahl benutzt. Voreinstellung: 1
  175.  
  176.     Test=T/S   :   Wird Test angegeben, wird eine übergebene Kommando-
  177.                    zeile oder ein ausgewähltes Programm nicht gestartet,
  178.                    sondern es wird nur im CLI Fenster angezeigt. Genauer
  179.                    gesagt, die Kommandozeile, wie PickFile sie starten
  180.                    würde, wird ausgegeben. Voreinstellung: AUS
  181.  
  182.     Quiet=Q/S  :   Wird Quiet angegeben, werden keine Informationen
  183.                    über die gestarteten Programme oder die getroffene
  184.                    Auswahl im CLI-Fenster ausgegeben. Normalerweise in-
  185.                    formiert PF den Benutzer über seine Auswahl. Wird aber
  186.                    PickFile bspw. in der Startup-Sequence aufgerufen, so
  187.                    würde jede Ausgabe, das CLI-Fenster erscheinen lassen
  188.                    (siehe auch AmigaDOS Handbuch Shell-Flag (AUTO)).
  189.                    Auch in Batch-Dateien ist eine Ausgabe manchmal uner-
  190.                    wünscht. Voreinstellung: AUS.
  191.  
  192.     Help=H/S   :   Wird Help angegeben oder ist ein Fehler in der Kom-
  193.                    mandozeile von PickFile, wird ein kurzer Hilfstext
  194.                    augegeben.
  195.  
  196.     Cmd=C/F    :   Dies ist die mächtigste Option. Hinter Cmd kann man
  197.                    eine vollständige Kommandozeile angeben, die dann als
  198.                    auszuführendes Kommando benutzt wird. Diese Option
  199.                    funktioniert sowohl bei Angabe einer Datei, sowie bei
  200.                    Angabe eines Verzeichnisses. Diese Kommandozeile kann
  201.                    man in Anfürungszeichen setzen, muß man aber nicht.
  202.                    Benutzt man eine andere als die Standart-Shell, wie
  203.                    z.B. CShell ist es ratsam im Zweifelsfall "" zu be-
  204.                    nutzen, damit z.B. Pattern nicht vorher expandiert
  205.                    werden.
  206.                    Alle in dieser Kommandozeile auftretenden [] werden
  207.                    automatisch von der Auswahl ersetzt. Wird eine mehr-
  208.                    fache Auswahl gewünscht, (siehe bei MaxValue), wird
  209.                    diese Kommandozeile für jede Auswahl erneut ausge-
  210.                    führt.
  211.                    Man kann PickFile hiermit auch zur Rekursion be-
  212.                    nutzen (Vorsicht).
  213.  
  214.     Für alle Optionen gilt: Beliebige Reihenfolge.
  215.  
  216.     Außnahme: Cmd muß als letzte Option übergeben werden.
  217.  
  218.     Alle Optionen sind optional (wie der Name schon sagt). Aber auch
  219.     hier gibt es eine Ausnahme (toll was?? :-) :
  220.  
  221.     Es muß entweder eine Datei oder ein Verzeichnis angegeben werden.
  222.     Wird sowohl eine Datei als auch ein Verzeichnis angegeben, wird
  223.     nur die Datei berücksichtigt.
  224.  
  225.     Zur Syntax der Datei muß noch einiges gesagt werden:
  226.  
  227.     Die Datei muß aus reinen ASCII-Zeichen bestehen. Es sind keine
  228.     Kommentare oder Ähnliches erlaubt, da dies auf Kosten der Ge-
  229.     schwindigkeit gehen würde.
  230.     Jede Zeile entspricht einer Kommandozeile. Wird keine Kommando-
  231.     zeile (siehe unter Cmd) zusätzlich angegeben, nimmt PF an, daß
  232.     es eine (oder mehrere) dieser Zeilen nach dem Zufallsprinzip
  233.     auswählen soll. Somit dürfte auch klar sein, daß führende Leer-
  234.     zeichen zu falschen Ergebnissen führen können, und somit lieber
  235.     weggelassen werden sollten.
  236.  
  237.  
  238. Beispiele:
  239. ==========
  240.  
  241.             Als nächstes folgen nun einige Beipiele für Kommandozeilen-
  242.             aufrufe von PickFile, Optionen und Einsatzbeispiele.
  243.  
  244.     1. Beipiel: Lottozahlen-Programm
  245.     --------------------------------
  246.  
  247.       Dieses Beipiel ist im Examples-Verzeichnis beigefügt und braucht
  248.       nicht abgetippt zu werden.
  249.  
  250.       Angenommen im aktuellen Verzeichnis befindet sich eine Datei, die
  251.       die Zahlen von 1 bis 49 enthält (Jede Zeile eine Zahl), und
  252.       `Lotto.dat` heißt.
  253.  
  254.       Angenommen wir wollen ein Programm, daß 6 Zufallszahlen aus 49
  255.       möglichen zufällig ermittelt, und das Resultat dann an den Drucker
  256.       senden, kann man folgenden Beipielaufruf benutzen:
  257.  
  258.       PickFile F Lotto.dat X 6 C "echo [] > PRT:"
  259.                |           |   |
  260.                |           |   ---> Diese Kommando wird mit der Auswahl
  261.                |           |        für jede Zahl gestartet.
  262.                |           |
  263.                |            ------> Dies gibt an, daß wir sechs mal eine
  264.                |                    Auswahl haben wollen.
  265.                |
  266.                 ------------------> Dies ist die Datei, mit den Einträgen,
  267.                                     die benutzt werden soll.
  268.  
  269.     2. Beipiel: Zufällige Auswahl von verschiedenen WBench Mustern
  270.     --------------------------------------------------------------
  271.  
  272.      Angenommen wir haben im Verzeichnis sys:Prefs/Presets viele verschie-
  273.      dene WBenchMuster (diese kann man mit dem Programm WBPattern erzeugen
  274.      und mit `Save As` abspeichern), die die Namen `wb.1.pat`,`wb.2.pat`
  275.      ... `wb.n.pat` haben.
  276.      Fügt man nun folgende Zeile in die Startup-Sequence ein:
  277.  
  278.      .....
  279.  
  280.      PickFile D Sys:Prefs/Presets/ P "wb.#?.pat" Q C
  281.          Copy [] env:sys/wbpat
  282.      .....
  283.      Endcli >NIL:
  284.  
  285.      , so wählt PickFile jedesmal, wenn der Computer bootet, eine der vie-
  286.      len `wb.##.pat`-Dateien zufällig aus. Um nur diese Dateien zu berück-
  287.      sichtigen, habe ich hier P (für Pat) als Suchmuster angegeben
  288.      (zu Suchmustern siehe auch AmigaDOS-Handbuch). Durch Q (für QUIET)
  289.      werden keine Ausgaben zum CLI-Fenster gemacht, d.h. das Fenster er-
  290.      scheint auch nicht.
  291.      Die Kommandozeile `Copy [] env:sys/wb.pat` wird z.Bsp. (Bei Auswahl
  292.      von wb.1.pat wie folgt ersetzt und gestartet.
  293.  
  294.            ====>  Copy wb.1.pat env:sys/wb.pat
  295.  
  296.      Nachdem irgendwann in der Startup-Sequence das Programm IPrefs gestar-
  297.      tet wird, wird diese Datei nun als WBenchmuster verwandt (super häh?).
  298.  
  299.  
  300.      Auch zum Ändern von anderen Dingen kann man diese Syntax leicht benut-
  301.      zen. etwa zum Ändern des Bildschirm-Typs (NTSC-PAL oder Interlaced-Non-
  302.      Interlaced etc...). Dazu muß man nur die Kommandozeile und die Dateien-
  303.      muster abändern.
  304.  
  305.  
  306.     3. Beipiel: SlideShow von mehreren Bildern mit zufälliger Reihenfolge
  307.     ---------------------------------------------------------------------
  308.  
  309.      Angenommen wir hätten eine Diskette mit dem Namen `PICTURES:` und
  310.      darauf 20 verschiedene Bilder. Nun können wir einfach mit folgender
  311.      Kommandozeile eine vollautomatische Slideshow erzeugen und starten.
  312.      Ich gehe dabei davon aus, daß sich im C:-Verzeichnis ein Bilder-
  313.      viewer-Programm mit dem Namen Show befindet.
  314.  
  315.        PickFile D Pictures: X 20 Q C echo PICTURES:[] >Ram:slide.dat
  316.  
  317.      Es werden nun alle 20 Bilder in zufälliger Reihenfolge ausgewählt
  318.      und in eine Datei in der RamDisk geschrieben. Wenn man jetzt z.B.
  319.      C:Show mit diesem File starten, kann man die Bilder in zufälliger
  320.      Reihenfolge betrachten.
  321.  
  322.      Wird anstelle der Kommandozeile, COM "C:Show []" angegeben, so wird
  323.      C:Show mit dem ersten Bild gestartet. Danach folgt das zweite usw.
  324.  
  325.      Die Anwendungen sind mannigfaltig. Gibt es bei euch noch andere
  326.      interessante Anwendungen, so schreibt mir doch einmal.
  327.  
  328.  
  329. Technisches:
  330. ============
  331.  
  332.     Ich habe in diesem Manual desöfteren von dem Zufallsprinzip ge-
  333.     sprochen. Dieser Pseudozufallsauswahl wird durch die aktuelle
  334.     Systemzeit (micros) initialisiert und dann mittels sran() ermit-
  335.     telt.
  336.     Bei Mehrfachauswahl ist dafür gesorgt daß, jede Auswahl nur ein-
  337.     mal ausgewählt werden kann. Auch Fehler bei der Menge der Auswahl,
  338.     werden berücksichtigt. Maximal können genauso viele Auswahlprozesse
  339.     getätigt werden, wie Zeilen in einer Datei oder Dateien in einem
  340.     Verzeichnis vorhanden sind.
  341.     Um Fehlern vorzubeugen, wird eine Auswahl von Verzeichnissen in
  342.     Verzeichnissen bei Angabe eines Verzeichnisses nicht unterstützt.
  343.     Auch beim Pattern-Matching werden keine Verzeichnisse berück-
  344.     sichtigt (außer natürlich bei Pfadangaben).
  345.  
  346.  
  347. Zum Schluß:
  348. ===========
  349.  
  350.     Ich hoffe, daß möglichst vielen Leuten dieses kleine Programm
  351.     gefällt und verbleibe bis dahin euer
  352.  
  353.         H.P.G
  354.  
  355.  
  356. Adresse:
  357. ========
  358.  
  359.     Hans-Peter Günther
  360.     Grüner Weg 5
  361.     3501 Fuldatal 2
  362.     W-Germany
  363.  
  364.  
  365. Liste der Dateien:
  366. ==================
  367.  
  368.  (Fehlt eine oder mehrere Dateien dieser Liste, ist diese Veröffentlichung
  369.   inkomplett)
  370.  
  371.     PickFile                : Das Programm
  372.     PickFile.info
  373.     PickFile.doc            : Englische Anleitung
  374.     PickFile.doc.info
  375.     PickFile.dok            : Deutsche Anleitung
  376.     PickFile.dok.info
  377.     Examples    (dir)
  378.     Examples
  379.         Lotto.dat           : Lotto Datei (Beipiel 1)
  380.         Lotto.dat.info
  381.  
  382. ----ENDE
  383.  
  384.